home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / qcom26.zip / QCOM.DOC < prev    next >
Text File  |  1991-09-28  |  34KB  |  907 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                   QCOM.EXE
  15.                                 Revision 2.60
  16.  
  17.                                  SEP 2, 1991
  18.              ------------------------------------------------
  19.                    Copyright 1990,1991 by Richard W Turenne
  20.                                  Winnipeg, Mb.
  21.                              All Rights Reserved
  22.  
  23.      All users are granted a limited license to try QCom for evaluation
  24.                    purposes to determine its' suitability.
  25.  
  26.  
  27.      QCom is USER SUPPORTED.  It is not Public Domain and is not free.
  28.       If you decide to use this program, please show your support by
  29.                                registering it.
  30.  
  31.  
  32.       To add INCENTIVE, those who register will be shown how to utilize
  33.         the user-defineable functions.  Users can pre-define other
  34.      external dos functions, or other external protocols, or batch files,
  35.                    and access them with a single keystroke.
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.             ---------------------------------------------------
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                QCom.Doc Page - 1
  59.  
  60.  
  61.  
  62.  
  63.   INTRODUCTION:
  64.  
  65.      QCOM is a compact communications program that attempts to pack in
  66.      maximum of function, form and ease of use into a small package.  It
  67.      was decided to primarily use external protocols for files transfers
  68.      because there are many available from which to choose.  And as the
  69.      technology of protocols progresses, it's a simple matter to keep your
  70.      communication software operating at the current state of the art.
  71.      This version of QCom now has XModem protocol built in.  It was  added
  72.      for two reasons: First without an external protocol of some sort,
  73.      QCom was helpless to transfer files.  Second, the XModem built into
  74.      QCom works noticeably faster than the one in DSZ.
  75.  
  76.      QCOM is tailored to use the shareware program DSZ by Omen Technology
  77.      to handle most file transfers.  When a file is to be transferred,
  78.      QCOM passes the proper commandline to DSZ which then handles all the
  79.      work of transferring and error checking.  It provides commonly used
  80.      Xmodem, Ymodem and Zmodem transfer methods.
  81.      (QCom can also be set up to use any other external protocol. See the
  82.      section on OTHER EXTERNAL PROTOCOLS.)
  83.  
  84.      When the file transfer is finished, QCOM resumes control.
  85.      NOTE:
  86.      DSZ.COM (or GSZ.EXE) MUST be present in the default directory or in
  87.      the DOS path if you wish to transfer files.  It may be obtained from
  88.      many local online sources.
  89.  
  90.  
  91.   FIRST TIME SETUP AND CONFIGURATION:
  92.  
  93.      Run the QCom Setup utility called QS.EXE.  Enter Com Port, screen
  94.      colors and select your modem from the list.  Pressing ENTER will
  95.      update the QCom configuration file.  Follow any instructions
  96.      relating to modem switches or jumpers.
  97.  
  98.      Run QCOM.  Wait a few moments while the modem is being initialized.
  99.      An error message usually means the modem has not been properly
  100.      initialized.
  101.  
  102.      You may need to refer to your modem instruction manual if you still
  103.      have problems.  One way to check initialization is to press ALT-M
  104.      when at the terminal screen to re-initialze the modem.  If you get
  105.      "ERROR" back from the modem then there is something in the string
  106.      that it doesn't understand. Refer to your modem manual to remove any
  107.      incorrect modem  commands from the string.  Pressing ALT-O when in
  108.      QCom allows you to edit the modem string contained in the
  109.      configuration file.  Also see the Trouble Shooting section that
  110.      follows later.
  111.  
  112.  
  113.  
  114.  
  115.                               QCom.Doc Page - 2
  116.  
  117.  
  118.  
  119.  
  120.   CONFIGURATION Continued...
  121.  
  122.      All configuration data is stored in the text file called QCOM.CFG.
  123.      If you wish, you can edit the file with any ascii editor as long as a
  124.      few rules are adhered to:
  125.  
  126.        a)The sequence and number of items in the file must not be altered.
  127.  
  128.        b)Each line should be no longer than 80 characters.  Longer lines
  129.          are truncated to 80 characters.
  130.  
  131.        c)Comments, if used, must be kept behind semicolons.
  132.  
  133.        d)The editor must not insert any hidden formatting or control
  134.          characters into the text.  If in doubt about your editor, edit it
  135.          within QCom using ALT-O.
  136.  
  137.     NOTE:
  138.        The "|" character will send a carriage return to the modem.  The
  139.        "~" is a half-second pause to allow the modem time to execute the
  140.        commands in the initialization string.  Some modems need more time
  141.        than others.  The pause is executed by QCom and the modem will not
  142.        actually receive the "~" character.
  143.        Function key definitions are shown in the last ten lines.  You can
  144.        configure your own "macros" here.  Control codes can be sent with
  145.        the use of the "^" character.
  146.        Example:
  147.              ^[ = an escape character
  148.              ^M = a carriage return
  149.        Refer to an ASCII chart for others.
  150.  
  151.   COMMANDLINE PARAMETERS:
  152.  
  153.        In addition to specifying a script,  the user can specify an
  154.        alternate configuration file and an alternate phone directory file.
  155.        This allows network users to have CFG and FON files tailored to
  156.        their individual needs.
  157.  
  158.       Switches are:
  159.             /S = load and execute script file
  160.             /C = load alternate configuration file
  161.             /P = load alternate phone directory
  162.  
  163.        Usage is: QCOM [/Sfilename.SCR] [/Cfilename.CFG] [/Pfilename.FON]
  164.  
  165.        Users may use the options in any sequence.  The switches (/S,/C,/P)
  166.        must NOT have a space preceeding the filename.  When the commandline
  167.        options are not used, QCom still defaults to QCom.CFG and QCom.FON.
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.                               QCom.Doc Page - 3
  177.  
  178.  
  179.  
  180.  
  181.   TERMINAL EMULATION:
  182.  
  183.     This version has built-in support for ANSI-BBS and straight TTY.
  184.     Pressing ALT-K will toggle between the two.
  185.  
  186.   STATUS LINE EXPLANATION:
  187.  
  188.     ----------------------------------------------------------------------
  189.     Alt-Z:Help │SEC │ Host system name     Online 05:55:55 │Z│ COM1:2400N8
  190.     ----------------------------------------------------------------------
  191.         │       ││││         │                │       │     │       │
  192.         │       ││││         │                │       │     │       │
  193.     Commands    ││││         │                │       │     │       │
  194.     Script on --┘│││         │                │       │     │       │
  195.     Echo On -----┘││         │                │       │     │       │
  196.     Capture On ---┘│         │                │       │     │       │
  197.     Alarm Off -----┘         │                │       │     │       │
  198.     Host name ---------------┘                │       │     │       │
  199.     Carrier status ---------------------------┘       │     │       │
  200.     Time connected -----------------------------------┘     │       │
  201.     Transfer protocol --------------------------------------┘       │
  202.     Communication port, baud, parity and databits ------------------┘
  203.  
  204.  
  205.  
  206.  
  207.   FILE TRANSFER PROTOCOLS:
  208.  
  209.      Transfer protocols are what DSZ uses as a method of flow-control and
  210.      error-checking when transferring files.  These protocols are
  211.      specified when adding to the Dialing Directory.  The Dialing
  212.      Directory is displayed when you press ALT-D.
  213.      The use of ZModem protocol is recommended if the host computer has
  214.      the option available.  QCom defaults to ZModem with crash recovery
  215.      and Moby Turbo enabled (z-rm).  This can be changed by bringing up
  216.      the configuration screen with ALT-O and editing the default ZModem
  217.      line.
  218.      When selecting XModem protocol, QCom defaults to using the built-in
  219.      XModem instead of DSZ's. This can be changed by editing the
  220.      appropriate line in QCom.CFG (press ALT-O in QCOM).
  221.  
  222.      If it becomes necessary to change your transfer protocol while on-
  223.      line, you can do so by pressing ALT-T.  A box will pop up to allow
  224.      you to make the change.  The current protocol is displayed in the
  225.      right-hand box on the status line (see STATUS LINE EXPLANATION
  226.      below).  It is VERY important that the protocols at the receiving and
  227.      transmitting ends are the same, otherwise DSZ will give a "Time Out"
  228.      error message and abort without transferring anything.
  229.  
  230.      Finding the required information on setting protocols in the DSZ
  231.      documentation can be challenging.  QCom gives the user a menu to
  232.      simplify selection and will send the command string that DSZ looks
  233.      for.  The following show the protocol commands QCom sends to DSZ.
  234.  
  235.  
  236.  
  237.                               QCom.Doc Page - 4
  238.  
  239.  
  240.  
  241.  
  242.   FILE TRANSFER CONTINUED...
  243.  
  244.     Protocol:        DSZ Command string:
  245.  
  246.     ZModem            "z -rm" (Can be changed in QCom.CFG)
  247.     YModem Batch      "b -cy"
  248.     YModem-G          "b -cgy"
  249.     XModem-CRC        "x -cy"
  250.     XModem-1K         "x -cky"
  251.     XModem-1K-G       "x -cgy"
  252.  
  253.  
  254.     The command that QCom gives to DSZ is the port and CONNECT baud rate
  255.     currently in use,  followed by an "s" or an "r" (depending on whether
  256.     the file is being sent or received) and the protocol string as in the
  257.     above  examples.
  258.  
  259.     TIP: Other options can be added by using SET DSZOPT=options in the
  260.     autoexec.bat file.  See the DSZ docs for options.
  261.  
  262.     The download path is added to the end of the  commandline when
  263.     downloading.  An unregistered copy of DSZ will ignore download paths
  264.     (this author will make no provision to defeat this).
  265.     The upload path precedes the filename specified by the user when the
  266.     upload command is issued.
  267.  
  268.     TIP:  If you upload files from different sub directories, keep the
  269.     default upload path blank in the QCom.CFG file.  When prompted for the
  270.     file to upload, enter the path and filename together
  271.     (Eg. C:\QCOM\QCOM.ZIP").
  272.  
  273.     Another tip:  Put the line "SET DSZLOG=C:\QCOM\QCOM.LOG" in your
  274.     Autoexec.bat file and DSZ will keep a log of your file transfers in
  275.     QCOM.LOG (This assumes that you have installed QCom on drive C: in a
  276.     subdirectory \QCOM.  You may change the path and log filename as you
  277.     wish.).
  278.     File transfers may be aborted with ESC followed by several CTRL-
  279.     BREAK's.
  280.  
  281.   OTHER EXTERNAL PROTOCOLS:
  282.  
  283.     QCom can be set up to use most external protocols.  Non-registered
  284.     uses can jump to Dos (ALT-J) and manually execute the external prot-
  285.     ocol.  Registered users will be shown how to pass parameters to the
  286.     external protocols and execute them with a single keystroke.  
  287.     Note: An unregistered copy of QCom is not "crippled".  The instruct-
  288.     ions for using this feature of QCom are provided to all those who
  289.     register.
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.                               QCom.Doc Page - 5
  300.  
  301.  
  302.  
  303.  
  304.   VARIOUS FUNCTIONS:
  305.  
  306.   ALT-A:
  307.       Toggles the sound functions on or off.
  308.   ALT-B:
  309.       Allows the user to scroll back through the last 500 lines of
  310.       received data.  Search capabilities are provided for finding
  311.       particular text and the whole buffer can be written to disk
  312.       using the Save command,"S" (the filename defaults to
  313.       "QComBuff.Txt") or erase it with "E".
  314.       The user can toggle the Ansi codes on or off while viewing the
  315.       buffer, by pressing "M".  
  316.   ALT-C:
  317.       Communication parameters can be modified here.  These changes
  318.       are in effect until changed again or until QCom ends.
  319.       Com Port must be set in QCOm.CFG. Port changes will not take
  320.       effect unless QCom is restarted.
  321.   ALT-D:
  322.       Displays the dialing directory.  Use the arrow keys to select
  323.       a number and ENTER to dial that number.  Other keys that are
  324.       PGUP, PGDN, HOME and END.  HOT TIP: Pressing ALT and a letter
  325.       will put the cursor on the first line beginning with that
  326.       letter.
  327.       Add a new entry with "A" or edit an existing one with "E".  To
  328.       delete an entry press "D".  You can dial the phone with a
  329.       manually entered number using "M".
  330.       Phone entries can be tagged or untagged with the Space bar.
  331.       This will cause QCom to continuously dial all tagged numbers
  332.       until a connection is made.  Dialing of tagged numbers will
  333.       commence when the Enter key is pressed.  Once a connection is
  334.       made and broken you will be returned to the Dialing Directory.
  335.       Continuous dialing will resume where it left off if Enter is
  336.       pressed again.
  337.   ALT-E:
  338.       Toggles local echo on or off.  This is used when the host does
  339.       not echo back the characters that you enter.  An "E" is
  340.       displayed in the left-hand box on the status line when local
  341.       echo is on.
  342.   ALT-G:
  343.       Toggles output to printer on and off.  Allows all incoming text to be
  344.       sent to the printer.  Host must be sending straight text with no ANSI
  345.       codes otherwise printout will be unintelligible.  Make sure the printer
  346.       is online.
  347.   ALT-H:
  348.       Sends the hang-up string to the modem and toggles DTR.
  349.   ALT-I:
  350.       Will save the current screen image to a text file as specified
  351.       in the QCom.CFG file.  Default filename is QCOM.SCN which can
  352.       be changed by editing the QCom.CFG file (use ALT-O).
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.                               QCom.Doc Page - 6
  361.  
  362.  
  363.  
  364.  
  365.   VARIOUS FUNCTIONS Continued...
  366.  
  367.   ALT-J:
  368.       Allows a quick exit to DOS without ending QCOM.  External
  369.       programs can be executed while on-line.  The user could make
  370.       use of other external file transfer protocols here if desired.
  371.   ALT-K:
  372.       Toggles between ANSI and TTY terminal emulation.
  373.   ALT-L:
  374.       Toggles the "capture" function.  If on, all incoming text will
  375.       be saved in a file named as specified in the QCom.CFG file.
  376.       Default is QCOM.CAP.  IF the file  does not exist in the
  377.       default directory, it will be created.  Otherwise data is
  378.       appended to an existing capture file.  A "C" is displayed in
  379.       the left-hand box on the status line when capture is on.
  380.       Also see the paragraph on QCFilter.
  381.   ALT-M:
  382.       Sends the modem initialization string to the modem.  This
  383.       string is automatically sent upon start-up (providing no
  384.       carrier is present).
  385.   ALT-O:
  386.       Brings up the QCOM.CFG file to the screen for editing.
  387.       Press F10 to save the file and to set the Communication
  388.       parameters as shown in the file.  Esc exits and makes no
  389.       changes.
  390.       If it were necessary to change baud or any other Communication
  391.       parameter while online, use ALT-O to edit and F10 to set
  392.       parameters.  Changing the port specified here will have no
  393.       effect unless QCom is  restarted.
  394.   ALT-P:
  395.       Sends the current password from an entry of the Dialing
  396.       directory when you have dialed and connected to that entry.
  397.   ALT-Q:
  398.       Load and execute a script.
  399.   ALT-R:
  400.       Re-dials the last phone number dialed when no entries are
  401.       "Tagged", or if entries are "Tagged", it will continue dialing
  402.       those.
  403.   ALT-S:
  404.       Toggles the Script Save function.  See the Script section for
  405.       more information on making and using scripts.
  406.   ALT-T:
  407.       Allows changing of the transfer protocol currently in effect.
  408.       This can be done while on-line.
  409.   ALT-V:
  410.       Allows the use of an external editor or file viewer.  The
  411.       editor (or file viewer) of choice is defined in the
  412.       configuration file.
  413.  
  414.  
  415.       
  416.  
  417.  
  418.  
  419.  
  420.  
  421.                               QCom.Doc Page - 7
  422.  
  423.  
  424.  
  425.  
  426.   VARIOUS FUNCTIONS Continued...
  427.  
  428.   ALT-U:
  429.       Will send a pure ascii text file to the host with no error-
  430.       checking.  Ascii transfer is used to send a text file to the
  431.       host PC.  For example, you might use it when sending a message
  432.       to an electronic mail service.  Instead of editing the message
  433.       on-line, you can prepare your message in advance.  Once on-
  434.       line, go into the message editing screen on the host and then
  435.       use ALT-U to upload your file.
  436.   ALT-W:
  437.       Wipes the screen clear.
  438.   ALT-X:
  439.       Ends QCOM.
  440.   ALT-Y:
  441.       QCom becomes the host computer.  It will wait for any incoming
  442.       phone calls.  When a call is received, QCom will answer the
  443.       phone.  At this point QCom reads in the file called
  444.       QCOMHOST.MSG and sends the contents to the caller's PC.  You
  445.       can edit this file to suit your own needs with any text
  446.       editor.  Also included is an Ansi colored version of the same
  447.       file called QCOMCOLR.MSG.  If you wish to send this ansi file
  448.       instead, then it must be renamed to QCOMHOST.MSG.
  449.  
  450.       After this message file is sent, the caller is shown the
  451.       following menu:
  452.  
  453.       "(A)rea (F)iles (C)hat (U)pload (D)ownLoad (P)rotocol (G)oodbye"
  454.  
  455.       The caller can select one of the choices or the Host can enter
  456.       selections.
  457.       "Area"  allows the user to change to a different subdirectory.
  458.       "Files" allows the user to list specified files in that
  459.       subdirctory.
  460.       "Chat"  will allow  a dialogue between each PC.  To end Chat
  461.       and return to the menu, the Host must press ESC.
  462.       "Upload"  will send a file to the Host using DSZ ZModem.
  463.       "Download" will send a file to the caller in a similar manner.
  464.       If the caller specifies the correct path and filename, he will
  465.       be able  to download a file from anywhere on the Host system.
  466.       "Protocols" will allow the caller to select XModem, YModem or
  467.       ZModem protocols when transferring files.
  468.       "Goodbye" will terminate the connection.
  469.       As Host, you can also terminate the call by pressing ALT-H to
  470.       hangup. QCom will then wait for the next caller.  ALT-X will
  471.       also terminate the call and in addition, end QCom.
  472.       A local Host mode test is available: Press ALT-Minus.  Allows
  473.       you to prepare and preview your own host welcome messages.
  474.   PGUP:
  475.       Uploads (sends) a file to the other system.  You will be
  476.       prompted to enter a filename to upload.  The file can be
  477.       preceeded by a path only if NO upload path is specified in
  478.       QCOM.CFG.  If the host supports batch uploads then you can
  479.       take advantage of DSZ's capabilities; when prompted for a file
  480.       to upload enter the name of a file containing a list of the
  481.       files you wish to upload.  Preceed the filename with an "@" .
  482.       Example: "@files.lst".
  483.  
  484.  
  485.       
  486.  
  487.                               QCom.Doc Page - 8
  488.  
  489.  
  490.  
  491.   VARIOUS FUNCTIONS Continued...
  492.  
  493.   PGDN:
  494.       Downloads (receives) a file from the host computer.  If XModem
  495.       or YModem are the protocols in effect, you'll be prompted to
  496.       enter the filename to receive.  QCom tries to guess the
  497.       filename based on recently entered text and places its' guess
  498.       at the prompt.
  499.       If ZModem is in effect, entry of filenames is not required.
  500.   ALT-=:
  501.       Toggles "Doorway" mode.  This removes the status line when in
  502.       Doorway mode and gives full screen display for using remote
  503.       applications.
  504.       Allows you to make full use of all keys while online.  All
  505.       Alt-key combinations except ALT-= are sent out and their usual
  506.       functions are disabled in this mode.   For example, PgUp,
  507.       PgDn, Home, End and the cursor key codes are transmitted.  You
  508.       might make use of this when using a full-screen editor while
  509.       online or when using your PC as a dumb terminal on a non-DOS
  510.       system such as Unix.  Status line and all key functions are
  511.       restored when Doorway mode is turned off.
  512.   ALT-Minus:
  513.       Enables local HostMode test.  End the test by selecting "G"
  514.       for GoodBye.
  515.   F1-F10:
  516.       Sends the text as listed in the last ten lines of QCom.CFG.
  517.       You can put your name, password, special key codes or whatever
  518.       you wish here. 80 characters max on each line.
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.                               QCom.Doc Page - 9
  538.  
  539.  
  540.  
  541.  
  542.   SCRIPT FUNCTIONS:
  543.  
  544.       QCom has a built-in Script-save feature to simplify the creation
  545.       of scripts.  Scripts can speed up logging in to a system and
  546.       automatically send commands and text to the host to accomplish
  547.       repetitive tasks easier.
  548.  
  549.       See the included QCOM.SCR for more examples on scripting.
  550.       In a QCom script, the semicolon is all important. It divides each
  551.       line into incoming and outgoing text. Lines beginning with a semicolon
  552.       are commands that QCom will execute.   Statements in parentheses
  553.       are comments for the purpose of explanation here and are not saved
  554.       in a real script.
  555.       Any line without a semicoln is ignored by QCom and can be used as
  556.       a comment line if you wish.
  557.  
  558.       Sample script :
  559.       ;ECHO ^M This is the start of my script! ^M (sends message to screen) 
  560.       ;a-L file.txt                   (capture the session to file.txt)
  561.       Do you want graphics (Enter)=no;^M
  562.       What is your first name?;PUT FIRSTNAME HERE^M  (sends first name)
  563.       What is your last name?;PUT LASTNAME HERE^M    (sends last name)
  564.       Password (Dots will echo)?;a-P  (sends password from Directory)
  565.       Scan Message Base Since 'Last Read' (Enter)=yes;^M
  566.       Press (Enter) to continue;^M
  567.       min. left) Main Board Command?;d^M            (downloading a file)
  568.       Filename to Download (Enter)=none?;file.arc^M
  569.       ;D/L file.arc                             (downloads "file.arc")
  570.       Press (Enter) to continue;^M
  571.       min. left) Main Board Command?;g^M            (goodbye!)
  572.       ;a-H Y                                    (give hangup command)
  573.       ;a-Q MyBBS.SCR                            (execute another script)
  574.  
  575.  
  576.       The following is an example of a script that connects to
  577.       CompuServe through DataPac:
  578.       
  579.       ;ECHO  Logging in to CompuServe.  Pease wait...
  580.       ;...^M                        (send "..." when connected)
  581.       DATAPAC;P 12345678^M          (send node id number)
  582.       Host Name:;CIS^M              (CompuServe Information Service)
  583.       User ID:;12345,6789^M         (insert your user ID)
  584.       Password:;a-P             (sends password from dialing directory)
  585.       Enter choice!;5^M          (check for mail or whatever)
  586.       Do you wish additional information (Y or N)!;N^M
  587.       etc, etc.
  588.  
  589.       In order to use a script automatically, put the name of the
  590.       script file in the SCRIPT column in the Dialing Directory.
  591.       One way to create a new script is to capture a session and then
  592.       edit it to conform to the above format, using the semicolons to
  593.       separate incoming and outgoing text.  Any unnecessary text can be
  594.       deleted from the capture file (such as news bulletins, etc.).
  595.       Rename the file using ".SCR" as the extension in your script
  596.       filename.
  597.  
  598.  
  599.  
  600.  
  601.                         QCom.Doc Page - 10
  602.  
  603.  
  604.  
  605.  
  606.   SCRIPT FUNCTIONS Continued...
  607.  
  608.       Another EASIER way to create a script is to use the Script Save
  609.       function:   First dial as you normally would.  Once connected,
  610.       press ALT-S to turn on the Save function.  When prompted, enter
  611.       the script filename (a previously existing script with the same
  612.       name will be overwritten.)  Use ".SCR" as the filename extension.
  613.       A lower case "s" will appear on the Status line indicating that a
  614.       script is being saved.
  615.  
  616.       Login entering your name, password etc. Type these in, don't use
  617.       shortcut keys or the script saver may not see them.  If/when
  618.       prompted to press "ANY" key always press ENTER otherwise QCom will
  619.       not store that line in the script.  (Also Note: BBS software
  620.       that has "HotKey" menu choices where the user is not required
  621.       to press ENTER after selecting a letter is great BUT... when it
  622.       comes to saving a script QCom will NOT save the line unless
  623.       you press ENTER.  So when saving a script turn off the Hotkey
  624.       feature at the BBS end.)
  625.       When finished with the script press ALT-S to toggle it off.  Enter
  626.       the name of your script into the Script column in the Dialing
  627.       Directory.
  628.       Next time you dial, the script will execute.  And if you wish,
  629.       you can edit this script with a text editor to add, modify or
  630.       remove lines.
  631.  
  632.       COMMANDLINE scripts are also possible; allowing you to
  633.       start Qcom, dial a number, download, hangup and end Qcom
  634.       automatically.
  635.       The first line will contain a DIAL command to call a phone number
  636.       selected from your dialing directory (eg. ";DIAL PC User Group").
  637.       Once connected,  the remainder of the script will be processed.
  638.       Also note:
  639.       When your script dials a directory  entry that has another script
  640.       specified, the second  script will be ignored.  You can, however,
  641.       call another script by using the ALT-Q command.
  642.       (eg. ";a-Q ANOTHER.SCR").
  643.  
  644.       To create a COMMANDLINE script, run Qcom, press ALT-S before going
  645.       into the Dialing Directory .  Once you have entered the name of
  646.       your script, proceed to step the program through the whole dialing
  647.       and connection procedure.  Qcom will save your commands as well as
  648.       the text coming in and going out.
  649.       This script must be run from the commandline like "QCom
  650.       BigBBS.scr".  (You must use the full script filename.)  It will
  651.       then execute the  commands and keystrokes as they were saved.
  652.       When a script is executing you will see an upper case "S" on the
  653.       Status line.  To stop script execution at any time, press the ESC
  654.       key.
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.                              QCom.Doc Page - 11
  663.  
  664.  
  665.  
  666.  
  667.   SCRIPT FUNCTIONS Continued...
  668.  
  669.       Bear in mind when making scripts that most BBS services will pause
  670.       every 24 lines or so and prompt you to press a key to continue;
  671.       especially when displaying long bulletins.
  672.       These prompts can occur at irregular occasions depending on the
  673.       amount of text being sent to you and can be difficult to handle
  674.       automatically from a scripting point of view.  One solution is to
  675.       turn OFF the pause at the BBS end in the user setup.  There is
  676.       usually an option allowing you to set the "page" length or number
  677.       of lines on your screen.  On most BBS's, setting it to zero will
  678.       turn off the pauses.  If you're afraid of missing anything then
  679.       turn capture on at the start of a session.  Or, you can use the
  680.       scroll-back function to review text that has gone off the screen.
  681.  
  682.  
  683.       A COUPLE OF CAUTIONS:  Any incoming phone noise is saved during a
  684.       Script Save procedure and will have to be edited out before using
  685.       the script.  It's wise to double-check a newly created script for
  686.       any unwanted characters.  Any pure text editor can be used to edit
  687.       or create a script file.
  688.  
  689.  
  690.   SYSTEM REQUIREMENTS:
  691.  
  692.      Minimum of one floppy drive, 256K or more memory, and a modem of
  693.      course.
  694.  
  695.  
  696.   SCREEN COLORS:
  697.  
  698.      Screen colors can be changed by modifying values given in the
  699.      configuration file QCom.CFG.  The easiest way is to use QS.EXE, the
  700.      QCom Setup program.
  701.  
  702.  
  703.   TROUBLE SHOOTING:
  704.  
  705.      Symptom:  "Cannot initialize Com Port x" error message. (x = 1 to 4)
  706.      Meaning of error message: Qcom cannot find the Com Port that is
  707.      specified in the configuration file (QCom.CFG).
  708.      Possible causes:
  709.      1. Error in configuration file.  The number specified there does not
  710.         match the Com Port used by the modem.
  711.      2. Hardware problem.  Two or more devices are configured for the same
  712.         Com port or the Com port specified is not installed. Or you may
  713.         have skipped a port or two, jumping from 1 to 4 without installing
  714.         2 and 3 first.  Try running QFix.exe as a temporary fix.
  715.         Permanent fix would involve setting the hardware so that there are
  716.         no skipped ports.
  717.      3. Software conflict. A memory resident program that ties up the Com
  718.         port has been previously executed and has not been deinstalled.
  719.         Carbon Copy is an example of such a program.
  720.  
  721.  
  722.  
  723.                            QCom.Doc Page - 12
  724.  
  725.  
  726.  
  727.  
  728.   TROUBLE SHOOTING Continued...
  729.  
  730.      Symptom: "Modem not responding"
  731.      Meaning of message: Modem did not respond with "OK" within the
  732.      alotted time.
  733.      Possible causes:  See the following:
  734.  
  735.      Symptom: Modem does not dial out.  Modem does not receive some/all
  736.      commands sent by QCom.
  737.      Possible causes:
  738.      1. Baud rate specified in the configuration file is too high for the
  739.         modem.
  740.         Set the default baud rate to your modem's fastest speed.  Modem
  741.         will send back an "OK" when you initialize the modem (Alt-M) if
  742.         all is well.
  743.      2. External modem is not powered up or not connected properly.
  744.  
  745.      3. Possible hardware conflicts with another installed serial device.
  746.         Internal modem has been improperly installed or configured.
  747.      4. Modem initialization or dialing prefix strings are incorrect.
  748.         Refer to the Modem instruction manual for the correct strings for
  749.         your modem.
  750.      5. Modem is incorrectly configured.  Refer to modem manual and set
  751.         modem dipswitches or NVRam for the following:
  752.         a) Modem should track the actual state of DCD (Carrier).
  753.         b) Modem should track DTR.
  754.         c) Modem must send back result codes after executing commands
  755.            ("OK").  (ATV1Q0X4)
  756.         d) Local echo off
  757.  
  758.      6. See the following.
  759.  
  760.      Symptom:  QCom status line says "Online" even when not.
  761.      Cause:
  762.      Modem Carrier Detect line is always on.  This MUST toggle on or off
  763.      depending on the actual Carrier state.  This is set with a modem dip
  764.      switch or a command sent in the initialization string.  Refer to the
  765.      modem manual.  Edit the initialization string if necessary and use
  766.      Alt-M to manually send the string to the modem.  Or toggle the
  767.      Carrier detect dip-switch if present.
  768.      Many modem factories typically set this to default to always on.
  769.      One result of this is QCom will prompt you whether you want to
  770.      initialize the modem at start-up which is an unnecessary annoyance
  771.      (the prompt is necessary in the instance where QCom is used as a dumb
  772.      terminal attached directly to another machine).
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.                        QCom.Doc Page - 13
  785.  
  786.  
  787.  
  788.  
  789.   TROUBLE SHOOTING Continued...
  790.  
  791.      Symptom: Pressing Alt-M to re-initialize the modem gets back "ERROR"
  792.      from the modem.
  793.      Cause:
  794.      The modem initialization string (line six in the QCom.CFG file)
  795.      contains command(s) that the modem does not understand.  Or, the
  796.      command string is too lengthy.  Refer to the modem manual and remove
  797.      any command not found in the manual.  Long init strings can be broken
  798.      up with "^M~~~AT" inserted between commands.
  799.  
  800.      Symptom: QCom reports "Unable to find DSZ.COM or DSZ.EXE"
  801.      Cause:
  802.      DSZ.COM or DSZ.EXE are not found in the default directory (the same
  803.      directory as QCom) or in the search path.  Put DSZ into correct
  804.      directory.
  805.  
  806.  
  807.   QCFilter:
  808.      If you've captured text that seems to be almost unintelligible
  809.      because it's loaded with strange codes and numbers then you'll
  810.      probably find QCFilter  useful.  This utility will filter Ansi escape
  811.      codes from captured text file and produce a copy of that file minus
  812.      all the codes and  colors.
  813.  
  814.      Usage: QCFilter InputFile OutputFile
  815.  
  816.      You MUST have Ansi.sys or an equivalent loaded for QCFilter to work
  817.      properly.
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.                            QCom.Doc Page - 14
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.                       --------------------------------
  855.  
  856.      It is hoped that you will find this program occasionally useful.
  857.      Comments or suggestions are welcome and can be left on CompuServe
  858.      72361,3117.  Mailing address is 206-215 Watson St., Winnipeg, Mb.,
  859.      Canada, R2P 2E1.
  860.  
  861.  
  862.      DISCLAIMER:
  863.  
  864.      This software is provided "as is" without warranty either express or
  865.      implied.  The user assumes all responsibility in determining its'
  866.      usefulness and or fitness for any purpose, and assumes all risks and
  867.      liabilities including damages for loss of business profits, business
  868.      interruption, or loss of business information arising from the
  869.      operation of this software.
  870.  
  871.  
  872.  
  873.             **************************************************
  874.                             QCOM REGISTRATION
  875.  
  876.                 If you use QCom,  please register it.  This
  877.               software is the result of a great deal of time
  878.           and effort.  Please support its' continued development.
  879.  
  880.     To add incentive, those who register will be shown how to utilize
  881.        the user-defineable functions.  Users can pre-define other
  882.       external protocols, for example, and access them with a single
  883.                                keystroke.
  884.  
  885.              The one-time registration fee is a modest $15.00.
  886.            To receive a copy of the absolute latest version on
  887.               disk, send an additional $5.00 to cover cost
  888.               of disk, packaging and mailing.  Specify disk
  889.                  size desired and your current version.
  890.  
  891.                      Send a check or money order to:
  892.  
  893.                              Richard Turenne
  894.                             206-215 Watson St.
  895.                            Winnipeg, Mb. Canada
  896.                                  R2P 2E1
  897.  
  898.                 Your comments, suggestions and bug reports
  899.               are always welcome whether or not you register.
  900.             **************************************************
  901.  
  902.  
  903.  
  904.  
  905.  
  906.                                 QCom.Doc Page - 15
  907.